SYSOP COMMANDS

                Personal Message System.  (C) 1994 G8NPF   

 This is a quick reference to commands available only to the SysOp.

        < > contains an mandatory argument.
        ( ) contains an optional argument.
         #  is a message number.


ACK <#>
        [Acknowledge]
        Acknowledge a message, using FBB ACK: protocol.

AD <sourcefilename> (destfilename)
        [Add file]
        Moves an ASCII text file from the upload directory to files area 0:
        allowing users access to that file. A new filename (destfilename) may
        be specified, but not a different drive or path. The file description
        database (SYS\filedesc.txt) will be updated using the information in
        the files DSC file. (The description the user entered when the file
        was uploaded)

AM <#> (filename) (/H)
        [Archive Message]
        Creates a file from message number #. If a filename is not specified,
        then the filename will be created from the message number. Archived
        messages are placed in the archive directory. Message headers are
        normally stripped off. To retain the headers add the /H switch to the
        end of the command line.

AU
        [AUdio]
        A three way toggles to set audio sounds to ON, OFF or TIMED. Setting to
        off, will suppress all audio. Setting to TIMED will only allowed audio
        within the range of times set by the config command AUDIOTIMES

CF <#> (path\filename) (description) (/H)
        [Create File]
        Creates a file from message number #. If a filename is not specified,
        then the filename will be created from the message number.
        Any directory path is assumed to be from files area 0:\
        If you wish to over-ride this, specify the FULL path from the drive
        letter.  i.e.  CF 1234 A:\OLD\thisfile.doc
        A text description of the file may be included, which will be used to
        update the file description database (SYS\filedesc.txt), but only if
        the destination of the file is files area 0:
        Message headers are normally stripped off. To retain the headers add
        the /H switch to the end of the command line.

CM <#> <callsign> (@BBS) (<FROM) (/type) (/H)
        [Copy Message]  (SysOp version)
        Copies message number # to another callsign. You may specify a new 
        @BBS field and a <FROM field. By default the message will be a personal
        message. You may include a /type parameter, which can be any
        valid message type (BPZUA), to override the default.
        Message headers are normally stripped off. To retain the headers add
        the /H switch to the end of the command line.
        e.g.  CM 234 ALL /B   will make the message a Bulletin to ALL

DK (options) </C>
        [Delete Killed]
        Removes killed messages from the message base and deletes the files
        from MAIL\ directory.
        The /C parameter must be used, or the command will be ignored.
        (See the L command for a description of the available options)
        *WARNING*  You cannot recover deleted messages.

DL <#1> (#2) (#n) </C)
        [Delete List]
        Deletes messages included in the list #1 #2 (#n).
        e.g. DL 123 234 345 /C  will delete messages numbered 123 234 345
        The /C parameter must be used, or the command will be ignored.
        *WARNING*  You can not recover deleted messages.

DL <#1-#2> </C>
        Deletes all messages between #1 and #2 inclusive.
        e.g. DL 423-435 /C  will delete 423 424 425... 434 435.
        The /C parameter must be used, or the command will be ignored.
        *WARNING*  You can not recover deleted messages.

DU <callsign>
        [Display User]
        Displays the user information for the callsign entered.

DW (callsign)     
        [Display Whitepages]
        Displays information held in the White Pages file.
        e.g. DW        Display all entries in shortform.
             DW *      Display all entries. (Could take a long time!)
             DW G8NPF  Display entry for G8NPF
             DW G6*    Display all G6 entries.

EF <filename>
        [Edit File]
        Edits a text file with the PMS's message editor.
        For *small* text files only.

EH <#>
        [Edit Header]
        Edits a message header's TO, @BBS, FROM and SUBJECT fields. You will be
        prompted for each entry in turn. To leave a field unchanged just press
        the <Return> key. Pressing the <Esc> key will skip any remaining fields

EM <#>
        [Edit Message]
        Edits the contents of a message.

EU <callsign>
        [Edit User details]
        Edits a users details as stored in the NAMELOG.SYS file.
        Entries are created automatically when a station first connects to the
        PMS. You may also manually create an entry for a station that has not
        yet logged on to the PMS. You will be prompted for each field in turn.
        To leave a field unchanged just press the <Return> key.
        Pressing the <Esc> key will skip any remaining fields.
        Numeric inputs can be in Hex (&H), Binary (&B), or Decimal.
        Invalid or out-of-range numeric fields will normally default to zero.

EW <callsign> <homebbs>
        [Edit Whitepages]
        Changes a users HOME BBS entry in the White Pages file, or adds a new
        entry if one does not already exist.
        e.g. EW G8NPF @GB7ESX

EXIT
        Closes down the PMS and returns you to the OS. The data cache will be
        saved first, and the BPQ code will be informed that the PMS is
        unavailable. You cannot EXIT if any channel is in the connected state,
        or using the editor.

FD <connect path> (options) (/D)
        [Forward]
        Starts a manual message forwarding session to a specific station.
        e.g. FD G8NPF-1:G6FBF-3
        Note that the manual forwarding system does NOT make any use of the
        information you may have set in the forwarding file. This allows you to
        forward messages to a station not normally held in the forwarding file.
        The option /D Inhibits duplicate checking, and can allow a duplicate
        message to be sent.
        
FH <#1> (#2) (#n)
        [Free Held]
        Restores messages that were placed on hold. You may specify multiple
        message numbers.

FL      [Forward List]
        Lists all messages waiting to be forwarded.

HM <#> (#2) <#n>
        [Hold Message]
        Places messages on hold. You may specify multiple message numbers.

JK (callsign)
        List of all logged users. You may specify a callsign, or part callsign.
        e.g.  JK         Displays all users.
              JK G8N*    Displays all users with callsign's starting with "G8N"

KD      [Kill forwarded]
        Kills all messages that have been forwarded.

KY      [Kill read]
        Kills all personal messages that have been read, but not killed.

LD      [List forwarded]
        Lists all messages that have been forwarded.

LH      [List Held]
        Lists all messages that have been placed on hold.

LK      [List Killed]
        Lists all messages that have been killed from the message list.

LQ      [List unread bulletins]
        Lists all bulletins unread by the SysOp.

LU      [List User]
        Lists messages that have been posted to all users. (SU)

LX      [List eXtra]
        Lists ALL messages, including those that have been killed.

LY      [List read]
        Lists all personal messages that have been read, but not killed.

LZ      [List autoread]
        Lists all unread type Z messages, created by the AutoRead functions.

MC <#> (#2) <#n>
        [Mark Cleared]
        Clears the 'SysOp's attention required' flag from a message. You may
        specify multiple message numbers.

MF <#> (#2) (#n)
        [Mark for Forward]
        Marks local messages for auto-forwarding. You may specify multiple
        message numbers.

MM <#> <parameters>
        [Mark Message]
        Advanced command to manually change the status of a message.
        Use with caution, and don't change things you don't understand!
        See the main documentation file for details.

MN <#> (#2) <#n>
        [Mark Normal]
        Can be used to unlock a locked message (after a crash?). The message
        can then be deleted normally. You may specify multiple message numbers.
                
MR <#> (#2) (#n)
        [Mark Read]
        Marks messages as 'read by the SysOp'.  You may specify multiple
        message numbers.

MS <#>
        [Message Status]
        Displays the advanced status information of a message.

PL <connect path>
        [Poll]
        Manually polls a station to forward/reverse-forward messages. Unlike
        the manual forward (FD) command, it will connect to the station even if
        the PMS has nothing to send.   e.g.  PL G8NPF-1:G6FBF
        This also allows you to collect messages from a station not normally
        included in forwarding sessions.

RESTART
        Re-boots the PMS software. Before re-booting, the PMS will disconnect
        any stations that may be logged on. Can be entered remotely by a
        station logged on with SysOp status.
        Generates 'pseudo' error 0

RK      [Read Killed]
        Similar to the normal Read, but will also read killed messages.

RQ      [Read unread bulletin]
        Reads all bulletins not yet read by the SysOp.

RZ      [Read autoread]
        Reads all unread messages created by the AutoRead functions.

SC <#> (TO @BBS <FROM) (/Q)
        [Send Comment]  Send a comment to message number #
        Similar to SR (Send Reply), but the message generated will normally
        retain the original TO and @BBS fields and is always type B$, whereas
        SR addresses the reply to the originating station, as message type PN.
        
SR <#> (TO @BBS <FROM) (/B) (/Q)
        [Send Reply]  Send a reply to message number #
        Similar to the users SR command, with the addition of the /B and /Q
        parameters. /B will make the reply into a BULLETIN rather than the
        default PERSONAL message. /Q will automatically quote the original
        message in the reply. You may also specify different TO, BBS and FROM
        fields. (See the SR command in the USER.DOC file for more info.)
        e.g.
        SR 452 /B            Send reply to msg 452 as a Bulletin.
        SR 452 @GB7ESX /Q    Send reply to msg 452 to BBS GB7ESX, quoting
                             the original message.

SZ      [Send autoread]
        Sends a type Z message. Type Z messages are normally only created by
        the AutoRead function. This command allows the SysOp to create such a
        message manually if required.

SU <group>
        [Send Users]
        Posts a message to all users of the PMS. When any user logs on, this
        message will appear as an unread personal message. Any user can read
        the message, but only the SysOp can kill it.
        The <group> can be anything you like. (i.e. ALL or USERS)

UK <#1> (#2) (#n)
        [UnKill]
        Un-kills messages. You may specify multiple message numbers.

UNPLUG
        Disconnects any stations that are logged on, and shuts the PMS down.
        This has the same effect as the EXIT command, but can be entered
        remotely by a station logged on with SysOp status.
        Generates 'pseudo' error 1

VK      Verbose RK

VQ      Verbose RQ

VZ      Verbose RZ

WA      [What Archived]
        Lists files that are in the archive directory.

WU      [What Uploaded]
        Lists files that are held in the upload files area.


F1
  Help for the PMS SysOp.
  You will be prompted for the command to find help on. The help text will be
  loaded into the editor for viewing. You cannot use this to modify the help
  text.

 Shift F1
 Request FBB password. Sends 'SYSOP' and replies to the numbers sent by the BBS

 Ctrl F1
  Sends the PMS ID string.  i.e. [NPF-n.nn-ABFLMHV$]

 Alt F1
  Request NNA password. Sends '@' and replies to the numbers sent by the BBS.


F2
  Stops the Scroll-lock LED flashing (until the next mail beacon).

 Shift F2 
  Disconnects the PMS from the BPQ node. (Will also abruptly disconnect any
  user from the node.)

 Ctrl F2 
  Disconnects a user from the PMS and returns them to the BPQ node.

 Alt F2
  Forces the PMS to execute a normal disconnect sequence, as if the user had
  entered the B (bye) command. You can use this to disconnect a user whenever
  the PMS is waiting for input.


F3
  Sets the monitor port mask.

 Shift F3
  Sets a callsign for selective monitoring. 
       
 Ctrl F3 
  Transmit a Binary file while in terminal mode. The function will prompt
  for the filename of the file to transmitted.

 Alt F3 
  Receive a Binary file while in terminal mode using Yapp protocol.
  The function will prompt for a local filename. If the file already exists,
  crash recovery mode is activated to resume an aborted download.


F4
  Starts an automatic 'FORWARDING' session to stations listed in the
  forwarding (FWDFILE.LST) file. A Forwarding session can be forced
  irrespective of the times you may have set in the NPFPMS.CFG file.

 Shift F4 
   (Reserved)
   
 Ctrl F4 
  Manual message purge. This function will start a purge of the message base,
  and kill/delete all date expired messages. It will also process any
  outstanding REQDIR, REQFIL, FNDFIL or WP requests.

 Alt F4
  Forces the 'Messages for:' beacon to be transmitted.


F5 
  Toggles the 'MONITOR' status on/off. This is used to monitor passing
  traffic. Only available on un-connected channels.

 Shift F5 
  Toggles the 'BUSY' status on/off. This is used to stop connections to a
  particular PMS channel.

 Ctrl F5
  Suspends/restores availability of the file servers. (Uploads/Downloads)

 Alt F5 
  Toggles the UP (enable FBB unproto update requests) flag on/off.


F6
  Edit the PMS log file.

 Shift F6
  Edit the bids record file.
 
 Ctrl F6
  Edit the Type B AutoList buffer file.

 Alt F6
  Edit the Type A AutoList buffer file.


F7 
  Resets the 'Wait' timer to the value set in the NPFPMS.CFG file.

 Shift F7 
  Resets the 'Session' timer to the value set in the NPFPMS.CFG file.

 Ctrl F7 
  Clears and restores the screen display.

 Alt F7 
  Switches between colour (VGA) and monochrome (MONO VGA) display.


F8
  Receive a compressed Binary file while in terminal mode. The function will
  prompt for a local filename. If the file already exists, it will be
  overwritten.

 Shift F8 
  Transmit a compressed Binary file while in terminal mode. The function will
  prompt for the filename of the file to transmitted.

 Ctrl F8 
  Forces a Type B AutoRead function.

 Alt F8  
  Forces a Type A AutoList/Read function.


F9
  Toggles the printer on/off.

 Shift F9
  Saves the review buffer of the current window to the file SYS\review.Cn
  where n is the PMS channel number.
  
 Ctrl F9 
  Transmit an ASCII file while in terminal mode. This function prompts for
  the name of the file to transmit. The file will be transmitted as if it was
  typed at the keyboard. Can be used to send (upload) an ASCII file.

 Alt F9 
  Opens a disk capture file and writes all incoming text to the file. The
  function will prompt for a file name. If the file already exists the file
  will be appended to. To close the capture file, press Alt F9 again.
  Can be used to download an ASCII file while in terminal mode.
  NOTE: Opening the SAME file from more than one PMS channel will produce a
        confused file!


F10
  Terminal mode. Connects you to the node using the PMS callsign. In terminal
  mode, you are able to use the PMS system as a simple terminal, enabling you
  to connect to other stations as a normal user.

 Shift F10 
  Terminal mode. As F10, but connects you to the node using the NODE callsign.
  
 Ctrl F10 
  Forces a user session to time-out.

 Alt F10 
  Requests a 'connected' callsign update from the BPQ code.
  

F11
  Switches the PMS display to the next channel up.


F12
  Switches the PMS display to the next channel down.

 
Keys.
 Ctrl RightShift
        [Dump user]
        This will immediately abort whatever a user is doing, and disconnect
        them. The user will not be informed of why they have been disconnected.
        Only use this as a last resort 'Panic Button'.

 PageUp
        [Chat request]
        Enters Chat mode, informing the user that you wish to chat with them.
        Also used in response to a 'Page alarm' from a user.
        Once in Chat mode, the PMS acts like a normal terminal.

 PageDown
        [End chat]
        Exits Chat mode, informing the user that you are returning them to
        the PMS.  Also used in response to a 'Page alarm' to inform the user
        that the SysOp is not available, without waiting for the normal alarm
        time-out.

 Ctrl PageUp
        [Review]
        Enters REVIEW mode. By using the cursor keys keys, you may scroll back
        and forth through text that has scrolled off the top of the screen. To
        exit REVIEW mode, press the <Esc> key.

 Ctrl LeftShift
 Inhibits the MAIL beacon after a user disconnects, or whenever the PMS is
 about to send a MAIL beacon.
 Terminates a FORWARD, POLL or AUTOLIST session at the end of the current
 connection.
 Aborts a users listing as if the user had sent an abort (A) command.
 Prevents the PMS from re-booting after closing down with an error condition.

 Alt LeftShift    (Similar to F12 key)
 Pressing these keys will switch the PMS display to the next channel up.

 Alt RightShift   (Similar to F11 key)
 Pressing these keys will switch the PMS display to the next channel down.

 Alt (0-9)
 Pressing Alt(0-9) will switch the PMS display to that channel (if valid).

 Tab
 When in TERMINAL or CHAT mode, the <Tab> key will add 3 chevrons plus a
 <Return> to the input line.   >>><Cr>

 Ctrl PageUp
 Activates review. You may scroll backwards and forwards with the cursor keys,
 PageUp, PageDown, Home and End keys.  Press <Esc> to exit the review mode.

Monitor mask.
 The mask number is a 4 digit hexadecimal number.
 The first digit is the frame mask, which sets the types of frames monitored.
 The value is a hex number from 0 to 7. It is a bit field where:
 Bit 1 enables the display of NODES broadcasts.
 Bit 2 enables the display of supervisory frames.
 Bit 3 enables the display of NetRom frames.
 Bit 4 is not used, and is always 0.
 Normal frames containing data (text) are always displayed.
 The default is 7 (bits 1-3 set) which means monitor all types of frames.

 The last 3 digits of the number are the BPQ radio port mask.
 The value is a 3 digit hex number from 000 to FFF. It is a bit field where:
 Bit 1 enables monitoring of radio port 1
 Bit 2 enables monitoring of radio port 2
  (...through to...)
 Bit 12 enables monitoring of radio port 12
 The default value of FFF (hex) means monitor all ports.

JA command.
 The JA command can accept 3 parameters (in any order).
 1. The number of entries to search. (Defaults to 12)
 2. The callsign/alias to search for.  * = wildcard.
 3. The BPQ port n, as Pn
 e.g.
   JA            List the last 12 entries
   JA 25         List the last 25 entries
   JA G9ABC      List all entries for G9ABC
   JA G9ABC-1    List all entries for G9ABC-1
   JA GB7E*      List all entries for GB7E...
   JA 30 P1      List the 30 most recent entries on port 1
   JA G9ABC P2   List all entries for G9ABC on port 2 only
   JA P1         List all entries on port 1

Editor.
 Whilst in the editor you can use the normal edit keys;
 Insert, Delete, Backspace, Arrow keys, Home, End, Page up, Page Down,
 and Ctrl+(edit key) to move around the text.

 ^Y   Delete an entire line.
 ^U   Re-insert the last line deleted, at the current line position.
 ^P   Allow the next character to be a control code.
 ^KA  Copy a marked block to the current cursor position.
 ^KB  Mark the start of a block.
 ^KH  Clear the markers.
 ^KK  Mark the end of a block.
 ^KP  Print a marked block. If no markers are set, then nothing is printed.
 ^KQ  Quit the editor without saving the file.
 ^KR  Read another file into the editor, at the current cursor position.
 ^KS  Save the file and stay in the editor.
 ^KV  Move a marked block to the current cursor position.
 ^KW  Append a marked block to a file.
 ^KX  Save the file, then quit the editor.
 ^KY  Delete a (small) marked block.
 <Enter>     Split the line, or create a new blank line.
 <Tab>       Inserts spaces to move the cursor to the next Tab position.

 ^ indicates a control key sequence. ^KR is <Ctrl>K followed by R

7Plus.
 The PMS can automatically convert 7Plus files received as messages into
 separate 7Plus files using the original filename extracted from the 7Plus
 header. e.g. If a multi-part 7Plus program has been sent to the PMS as message
 numbers 201, 202 and 203 then enter the command:  D7 201 202 203
 D7 is the command, followed by the relevant message numbers.
 It will create 3 files in the 7PLUS\ sub-directory called xxx.P01 xxx.P02 and
 xxx.P03 (The xxx being the original filename)

 Note: The PMS does not actually decode the files.  It converts message files
 into 7Plus files ready for decoding with 7PLUS.EXE
 
<EOF>